﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<title>Readme &mdash; Lilina News Aggregator</title>
		<style type="text/css">
			@import "install.css";
		</style>
		<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
	</head>
	<body>
		<div id="container">
			<img id="header-logo" src="inc/templates/default/logo-small.png" alt="Lilina Logo" />
			<h1>Lilina Readme &mdash; Version 1.0 Alpha 2</h1>
			<h2 id="welcome">Welcome!</h2>
				<p>Welcome and thanks for downloading Lilina! This file is designed to give you a guide into the installation and use of the Lilina News Aggregator software.</p>
			<h2 id="about">About</h2>
				<p>Lilina is an open source feed aggregator, or feed reader, written in PHP. It doesn't require any PEAR or PECL packages and is simple to set up and use.</p>
				<p>This software is Open Source Initiative approved Open Source Software. Open Source Initiative Approved is a trademark of the Open Source Initiative.</p>
			<h2 id="requirements">Requirements</h2>
				<ul><li>A webserver, like Apache or IIS</li>
				<li>PHP 4.3+</li>
				<li>The <a href="http://php.net/xml">XML entension</a></li>
				<li>Support for <a href="http://php.net/pcre">PCRE</a></li>
				<li>Either:
					<ul>
						<li>The <a href="http://php.net/mbstring">mbstring</a> extension <strong>or</strong></li>
						<li>The <a href="http://php.net/iconv">iconv</a> extension</li>
					</ul></li>
				<li>Either:
					<ul><li>Support for socket connections (see <a href="http://php.net/manual/en/function.fsockopen.php">the PHP manual entry on fsockopen</a>) <strong>or</strong></li>
					<li>The cURL extension (see <a href="http://au.php.net/curl">the PHP manual entry on cURL</a>)</li>
					</ul></li>
				</ul>
				<p>That's it! No PEAR packages are needed and no MySQL, PostgreSQL or SQLite databases are needed. Lilina is fully self-contained and uses flat-files instead of databases.</p>
			<h2 id="installation">Installation</h2>
				<p>Upload to your server and then simply open up <a href="install.php">install.php</a> in your browser</p>
			<h2 id="permissions">Permissions</h2>
				<p>To use Lilina, you will need to make sure that both your <code>cache/</code> and <code>conf/</code> directories are writable. You can set the proper permissions using:</p>
				<pre>chmod -R 0755 cache conf</pre>
				<p>If that does not work, you will need to give the folder world writable permissions. This is not recommended as it is then possible for anyone to edit your files. You can set it by executing:</p>
				<pre>chmod -R 0777 cache conf</pre>
				<p>If you use a graphical FTP client, you can also set it on each folder using the number 755 or 777, or giving read and execute permissions to all and the write permission to the owner only</p>
			<h2 id="support">Support</h2>
				<p>Support is available from the <a href="http://getlilina.org/docs/support">Lilina support page</a>, <a href="http://getlilina.org/forums/">the Lilina forums</a> or <a href="http://getlilina.org/docs/">on the Lilina wiki</a>.</p>
			<img id="logo" src="inc/templates/default/logo-small.png" alt="Lilina Logo" />
		</div>
	</body>
</html>